<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
<!-- desktop-integration.qdoc -->
  <title>Desktop Integration | Qt 5.14</title>
  <link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
  <script type="text/javascript">
    document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
    // loading style sheet breaks anchors that were jumped to before
    // so force jumping to anchor again
    setTimeout(function() {
        var anchor = location.hash;
        // need to jump to different anchor first (e.g. none)
        location.hash = "#";
        setTimeout(function() {
            location.hash = anchor;
        }, 0);
    }, 0);
  </script>
</head>
<body>
<div class="header" id="qtdocheader">
  <div class="main">
    <div class="main-rounded">
      <div class="navigationbar">
        <table><tr>
<td ><a href="index.html">Qt 5.14</a></td><td >Desktop Integration</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right">Qt 5.14.2 Reference Documentation</td>
        </tr></table>
      </div>
    </div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#useful-classes">Useful Classes</a></li>
<li class="level1"><a href="#opening-external-resources">Opening External Resources</a></li>
<li class="level1"><a href="#system-tray-icons">System Tray Icons</a></li>
<li class="level1"><a href="#desktop-widgets">Desktop Widgets</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Desktop Integration</h1>
<span class="subtitle"></span>
<!-- $$$desktop-integration.html-description -->
<div class="descr"> <a name="details"></a>
<p>Qt applications behave well in the user's desktop environment, but certain integrations require additional, and sometimes platform specific, techniques.</p>
<a name="useful-classes"></a>
<h2 id="useful-classes">Useful Classes</h2>
<p>Various classes in Qt are designed to help developers integrate applications into users' desktop environments. These classes enable developers to take advantage of native services while still using a cross-platform API.</p>
<div class="table"><table class="annotated">
<tr class="odd topAlign"><td class="tblName"><p><a href="../qtgui/qdesktopservices.html">QDesktopServices</a></p></td><td class="tblDescr"><p>Methods for accessing common desktop services</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="../qtwidgets/qsystemtrayicon.html">QSystemTrayIcon</a></p></td><td class="tblDescr"><p>Icon for an application in the system tray</p></td></tr>
</table></div>
<a name="opening-external-resources"></a>
<h2 id="opening-external-resources">Opening External Resources</h2>
<p>Although Qt provides facilities to handle and display resources, such as <a href="../qtgui/qimageiohandler.html">common image formats</a> and <a href="../qtgui/qtextdocument.html">HTML</a>, it is sometimes necessary to open files and external resources using external applications.</p>
<p><a href="../qtgui/qdesktopservices.html">QDesktopServices</a> provides an interface to services offered by the user's desktop environment. In particular, the <a href="../qtgui/qdesktopservices.html#openUrl">openUrl()</a> function is used to open resources using the appropriate application, which may have been specifically configured by the user.</p>
<a name="system-tray-icons"></a>
<h2 id="system-tray-icons">System Tray Icons</h2>
<p>Many modern desktop environments feature docks or panels with <i>system trays</i> in which applications can install icons. Applications often use system tray icons to display status information, either by updating the icon itself or by showing information in &quot;balloon messages&quot;. Additionally, many applications provide pop-up menus that can be accessed via their system tray icons.</p>
<p>The <a href="../qtwidgets/qsystemtrayicon.html">QSystemTrayIcon</a> class exposes all of the above features via an intuitive Qt-style API that can be used on all desktop platforms.</p>
<a name="desktop-widgets"></a>
<h2 id="desktop-widgets">Desktop Widgets</h2>
<p>On systems where the user's desktop is displayed using more than one screen, certain types of applications may need to obtain information about the configuration of the user's workspace to ensure that new windows and dialogs are opened in appropriate locations.</p>
<p>The QDesktopWidget class can be used to monitor the positions of widgets and notify applications about changes to the way the desktop is split over the available screens. This enables applications to implement policies for positioning new windows so that, for example, they do not distract a user who is working on a specific task.</p>
</div>
<!-- @@@desktop-integration.html -->
        </div>
       </div>
   </div>
   </div>
</div>
<div class="footer">
   <p>
   <acronym title="Copyright">&copy;</acronym> 2020 The Qt Company Ltd.
   Documentation contributions included herein are the copyrights of
   their respective owners.<br/>    The documentation provided herein is licensed under the terms of the    <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation    License version 1.3</a> as published by the Free Software Foundation.<br/>    Qt and respective logos are trademarks of The Qt Company Ltd.     in Finland and/or other countries worldwide. All other trademarks are property
   of their respective owners. </p>
</div>
</body>
</html>
